XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll - The DialogShell widget class
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/DialogS.h>
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Modal and modeless dialogs use DialogShell as the Shell
parent. DialogShell widgets cannot be iconified. Instead,
all secondary DialogShell widgets associated with an
ApplicationShell widget are iconified and de-iconified as a
group with the primary widget.
The client indirectly manipulates DialogShell through the
convenience interfaces during creation, and it can directly
manipulate its BulletinBoard-derived child. Much of the
functionality of DialogShell assumes that its child is a
BulletinBoard subclass, although it can potentially stand
alone.
Setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt, XXXXmmmmNNNNwwwwiiiiddddtttthhhh, or XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh for either a
DialogShell or its managed child usually sets that resource
to the same value in both the parent and the child. When an
off-the-spot input method exists, the height and width of
the shell may be greater than those of the managed child in
order to accommodate the input method. In this case,
setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhttttor XXXXmmmmNNNNwwwwiiiiddddtttthhhh for the shell does not
necessarily set that resource to the same value in the
managed child, and setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhttttor XXXXmmmmNNNNwwwwiiiiddddtttthhhhfor the child
does not necessarily set that resource to the same value in
the shell.
For the managed child of a DialogShell, regardless of the
value of the shell's XXXXmmmmNNNNaaaalllllllloooowwwwSSSShhhheeeellllllllRRRReeeessssiiiizzzzeeee resource, setting
XXXXmmmmNNNNxxxx or XXXXmmmmNNNNyyyysets the corresponding resource of the parent
but does not change the child's position relative to the
parent. The XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss resource for the child's XXXXmmmmNNNNxxxx or
XXXXmmmmNNNNyyyy yields the value of the corresponding resource in the
parent. The x and y-coordinates of the child's upper left
outside corner relative to the parent's upper left inside
corner are both 0 (zero) minus the value of XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh.
Note that the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l
(ICCCM) allows a window manager to change or control the
border width of a reparented top-level window.
DialogShell uses the _X_m_Q_T_d_i_a_l_o_g_S_h_e_l_l_S_a_v_v_y trait.
DialogShell inherits behavior, resources, and traits from
the CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, SSSShhhheeeellllllll, WWWWMMMMSSSShhhheeeellllllll, VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll, and
WWWWMMMMSSSShhhheeeellllllll(3), VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3), and XXXXmmmmCCCCrrrreeeeaaaatttteeeeDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll(3).